'Payment start' hívás indítása

A 'Payment start' hívást a rafipay-ofo-service API séma alapján kell összeállítani.

Végpont

POST {BaseURL}/v1/ofo/start

Header

Mezők:

Mező	Típus	Leírás
Signature	string (hex)	a fent leírt módon generált HMAC signature
X-Request-ID	string (uuid)	kereskedő által UUID sémában kiosztott egyedi hívásazonosító, mely az adott hívást azonosítja
X-Correlation-ID	string (uuid)	kereskedő által UUID sémában kiosztott egyedi munkamenet-azonosító, mely a teljes munkamenetet azonosítja

Body

A "Payload összeállítása" pontban leírt payload, tartalma és formája meg kell egyezzen a signature létrehozás során összeállított payloaddal. Ha a végpontra beküldött payload és a payload amiből előállt a HMAC signature eltér, az HMAC signature hibához vezet.

request body

{
    "idempotencyKey": "b14107ae-ede2-4313-ab25-57b633ff0e66",
    "technicalUserId": "",
    "language": "HU",
    "url": "https://www.raiffeisen.hu/fizetesikerelem",
    "transactionReference": "ID48275648744066",
    "paymentMethods": [
      "EAM"
    ],
    "transactionCurrency": "HUF",
    "transactionAmount": 101,
    "remittanceInfo": "árvíztűrő tükörfúrógép",
    "shopId": "1234",
    "terminalReference": "string",
    "timestamp": "2026-02-20T13:50:07.883Z"
}

Response

Sikeres kérés esetén az alábbi kódot adja vissza a szolgáltatás:

200: Payment created

A sikeres hívás eredményeképp a Raiffeisen PAY szolgáltatás (rafipay-vpos-service) előállít egy payment URL-t, és visszaadja azt a válaszban.

{
  "salt": "string", 
  "redirectUrl": "string" 
} 

Sikertelen kérés esetén az alábbi hibakódokat adhatja vissza a szolgáltatás:

400: General error response

401: Access Denied. Hibás vagy hiányzó HMAC signature.

{ 
  "errorId": "string", 
  "errorCode": "string",
  "errorDescription": "string", 
  "errorDetails": [ 
    {
      "field": "string", 
      "errorDescription": "string" 
    } 
  ] 
}

Vásárló átirányítása az Online Fizetési Oldalra

A vásárlót a Payment start hívásra adott válaszban kapott redirect URL-re kell irányítani. Az Online Fizetési Oldal megjeleníti az azonnali fizetéshez szükséges QR kódot és/vagy Deeplinket.

A tranzakció befejezése után a fizetési oldalon megjelenik a tranzakció eredménye, valamint a kereskedő oldalára mutató (a payloadban "url"-ként megadott) visszatérési/redirect link.

Callback URL

A Callback URL használata azokban az esetekben értelmezett, amikor a fizetési folyamatot a fizető fél eszközén lévő, a mobilbanki alkalmazástól eltérő alkalmazásból kezdeményezik. A CallBack URL segítségével a fizetés végén a fizető fél visszatérhet arra a felületre, ahonnan a vásárlást kezdeményezte. Ilyen felületek lehetnek: online áruház fizetés státusz oldala, alkalmazáson belüli vásárlás esetén az adott alkalmazás fizetés státusz oldala, vagy loyalty alkalmazás fizetés utáni landing oldala. A felület önmagában is jelzi a fizetés sikerességét, vagy elutasítását.

Az Aggregátor által megképzett EAM-ba internetes vásárlás esetén URL, alkalmazáson belüli vásrálás esetén pedig Deeplink igényelhető.

A payloadban "url" mező egyezik meg a callback url-el.

Jó tudni

Abban az esetben, ha IPEW kódot kívánnak használni a callback url megadása kötelező előzetesen a szerződéskötés alkalmával, API hívás során nem kell adni a callback url-t.

Lejárat (Expiry)

Az EAM kérések lejárata 15 perc, csakúgy, mint az RTP kéréseknek, azonban az RTP esetén a core rendszer később járatja le, és 15 perc után már nem elfogadható, status lekérdezésnél később állítódik át.